Carrossel

O Bloco de "Carrossel" do Digital Contact Bots permite exibir conteúdos em formato de carrossel deslizável, com até 15 cards por bloco. Esse recurso é útil para apresentar produtos, serviços ou opções interativas ao usuário.

Configurações do bloco "Carrossel" no Digital Contact Bots

O Bloco de "Carrossel" pode ser encontrado no menu lateral, dentro da seção “Texto e Menu”.

Ao ser inserido no fluxo, ele aparecerá assim:

Após ser configurado, o bloco assume a seguinte aparência:

O menu lateral do Bloco de Carrossel contém os seguintes campos:

Ao expandir a opção de ação, serão exibidos os botões.

Título do Carrossel: texto exibido acima dos cards no WhatsApp. Pode ter até 1.024 caracteres. Para outros canais esse campo é ignorado. Caso o campo seja deixado em branco em um bot com canal WhatsApp, o sistema utiliza o título do próprio bloco como fallback; se o título do bloco também estiver vazio, um ponto (.) é enviado automaticamente para satisfazer o requisito da API.

Cada carrossel pode conter até 15 cards, e cada card inclui:

• Fazer Upload / URL ou Variável seleção da origem da imagem do card.

• URL ou variável quando a opção acima for URL ou variável esse campo será disponibilizado para inclusão dos valores.

• Imagem: suporta arquivos de até 15 MB. Pode ser adicionada arrastando o arquivo ou selecionando através do botão.

  • Após configurar a imagem , a exibição fica com os seguintes estados possíves:

• Título: limite de 13 caracteres na exibição (caso ultrapasse, será exibido com reticências “…”). Para o WhatsApp, o título é inserido no corpo do card junto com a descrição — veja detalhes na seção Comportamento no WhatsApp.

• Descrição: limite de 600 caracteres. Para o WhatsApp, o total de Título + Descrição deve respeitar o limite — veja detalhes na seção Comportamento no WhatsApp.

• Botões: até 4 botões por card. Cada botão pode conter até 20 caracteres. Os botões podem ser configurados com os seguintes destinos:

  • 1. URL: limitado a 200 caracteres.
  • 2. Telefone: composto pelo DDD e número
  • 3. Bloco: permite direcionar o usuário para outro bloco do fluxo. Ao selecionar esse destino, um campo opcional Id do botão é exibido — permite atribuir um identificador personalizado ao botão para fins de rastreamento nos relatórios e salvamento em variável.
  • 4. Copiar: permite que o usuário copie um texto ou o conteúdo de uma variável.

Para configurar um botão:

1. clique no botão desejado.
2. edite o nome e defina o destino (URL, telefone, bloco ou copiar).

O nome do botão e o destino configurado aparecem ao lado de “Destino >”, facilitando a identificação:

Para adicionar um novo card, clique no botão ”+” ao lado da imagem:

Quando há mais de um card, o botão de excluir card fica disponível, permitindo remover um item caso necessário:

A navegação entre os cards pode ser feita através das setas laterais:

Após as configurações, é assim que o carrossel se parecerá no WebChat e no WhatsApp:

O uso exclusivo de “Variáveis bloqueadas” (não enviadas ao cliente) poderá influênciar no comportamento do bloco devido a limitações do canal.

---

Prosseguimento do fluxo.

• Quando está opção estiver ativada, permite que o bloco siga automaticamente para o próximo bloco, mesmo que existam botões direcionadores configurados.
• Caso esta opção esteja ativada e o bloco não estiver ligado a um próximo bloco o fluxo seguirá de acordo com o que está configurado no Escape do bloco.

---

Salvar ID da resposta

Abaixo das configurações dos cards, o bloco de Carrossel oferece a opção de capturar o ID do botão clicado pelo usuário e armazená-lo em uma variável do fluxo.

Como funcionar:

1. Ative o switch "Armazene a resposta em uma variável" na seção "Salvar ID da resposta".
2. Selecione (ou crie) a variável onde o ID será salvo. Após o clique do usuário, a variável receberá o valor do campo Id do botão configurado naquele botão.

Observação: para que o valor seja salvo, o botão precisa ter o campo Id do botão preenchido e o destino deve ser do tipo Bloco.

---

Comportamento no WhatsApp

O bloco de Carrossel funciona no canal WhatsApp exclusivamente com o provedor Sendfy Cloud. Abaixo estão as regras e limitações específicas desse canal.

Título do Carrossel

No WhatsApp, o campo Título do Carrossel é obrigatório, ele corresponde ao texto da mensagem principal exibida acima dos cards. Configure-o no campo "Título do Carrossel" no painel do bloco.

Caso o campo seja deixado em branco, o sistema aplica o seguinte fallback em ordem: Usa o título do bloco (campo "Título" no cabeçalho do bloco no builder), se preenchido. Se o título do bloco também estiver vazio, envia um ponto (.) automaticamente.

Número de cards

O WhatsApp exige no mínimo 2 e no máximo 10 cards por carrossel (limitação da Meta). Se o bloco tiver fora desse intervalo, o carrossel não será enviado.

Consistência de botões entre cards

Todos os cards do carrossel devem ter o mesmo tipo e a mesma quantidade de botões. Caso haja inconsistência, o carrossel é bloqueado e a conversa é encerrada automaticamente. O builder exibe um aviso quando o bot possui o canal WhatsApp configurado.

Tipos de botão suportados no WhatsApp

No WhatsApp, apenas dois tipos de destino de botão funcionam:

Tipo no builder	Como é enviado ao WhatsApp	Observação
URL	cta_url	Somente 1 botão URL por card (os demais são ignorados); rótulo: máx. 20 caracteres
Bloco	quick_reply	Múltiplos botões permitidos; rótulo: máx. 20 caracteres

Todos os cards devem usar o mesmo tipo de botão (todos URL ou todos Bloco).

Título e Descrição do card no WhatsApp

A soma de Título + Descrição do card deve ter no máximo 160 caracteres no total (limitação da Meta). Conteúdo que ultrapassar esse limite será truncado na entrega.

Regras para execução do Escape configurado no bloco.

As regras abaixo, são válidas para o canal do Whatsapp, os canais onde o Carrossel ainda não é suportado (Facebook Messenger, Instagram, e Google Chat) direcionam o fluxo diretamente para Escape.

• Quando houver apenas UM CARD.
• Quando houver MAIS de 10 CARDS.
• Quando qualquer CARD tiver um botão de tipo diferente.
• Quando tiver CARD com números DIFERENTES de botões.